home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / fade into you / getting there / Apps / Finger-150 / Documentation next >
Text File  |  1994-10-21  |  12KB  |  213 lines

  1. Finger v1.5.0 © 1991-1994 Peter N Lewis
  2. This program is $10 shareware.
  3.  
  4. • Contents
  5.  
  6.       What Finger Does
  7.       Using Finger
  8.       How It Works
  9.       Limitations
  10.       Small Print
  11.       Warranty
  12.       Fine Print
  13.       Version History
  14.       Acknowledgements
  15.       The Author
  16.  
  17. • What Finger Does
  18.  
  19. Finger is a Macintosh implementation of the Un*x Finger protocol that allows you to finger anyone in the world.  Finger is AppleScriptable and Recordable.
  20.  
  21. • Using Finger
  22.  
  23. You must have MacTCP installed in order to use either of these applications.
  24.  
  25. To use Finger, first launch Finger and choose Finger… from the File menu.  Enter the machine name and (optionally) the user name of the person you wish to finger (Note: If you have used unix, you may prefer to type user@machine into either field (and if you do prefer to do this, go ahead, cuz it will work :-)).  You can choose to query either a Finger server or a Whois Server by clicking the Whois checkbox.  Then Click the Finger button.  Finger will add any successful addresses to the Finger hierarchical menu.  You can save this menu by choosing Save Finger Menu from the File menu.  
  26.  
  27. You can also control Finger using AppleScript.  Finger supports the full standard URL suite (indeed it is the first application to do so).  Here are some examples:
  28.  
  29. set err to geturl "finger://user@host"
  30. set err to geturl "finger://host/user"
  31. set err to geturl "whois://host/host"
  32. set err to geturl "whois://host/host" to (file "harddisk:whois")
  33. set res to fetchurl "finger://host@host"
  34.  
  35. So you can ask Finger to display the results, store them in a file or return them to your script for further processing.  Finger also supports it’s own custom suite that lets you do:
  36.  
  37. set err to finger "host@host"
  38. set err to whois "host@host"
  39.  
  40. but these only allow you to direct Finger to display the results.  If you want more control, use the standard suite.
  41.  
  42. Finger also creates and uses AURL documents (the same kind of documents that Fetch and Anarchie use - these documents are not interchangeable, but they provide a standard way for other applications to make use of Finger).  You can save Finger AURL documents by choosing Finger… and then filling in the fields and clickign the Save button.  Double clicking these documents in the Finder will finger the person you specified.
  43.  
  44. • How It Works
  45.  
  46. When you choose Finger from the File menu, it will ask you for a machine and user name.  It will then attempt to find the machine, open port 79 (or 43 for the Whois Server, both port numbers specified in STR# 300), and send the username to it.  Then it will display whatever information the remote machine returns, up to 30k bytes.
  47.  
  48. Finger translates the incoming and outgoing characters between the Mac's 8-bit characters and the standard network ISO-8859-1 character set.
  49.  
  50. • Limitations
  51.  
  52. Finger probably requires the 128k ROM and System version 6.0 or higher and MacTCP v1.1 or later.  If Finger runs low on memory it will disable the Finger… menu item.  If this happens give it more memory!  I haven’t tried this under System 6, it may no longer work there.
  53.  
  54. • Small Print
  55.  
  56. This program is Shareware, which means if you use it, you should send me US$10.  You can pay in US$ cash, checks, VISA, MasterCard, American Express or NetCash.  Use the Register program (included with the package) to fill out the registration form and send it to the specified address via Email, Snail-mail, or FAX.
  57.  
  58. Site Licensing:
  59. World-wide license: US$1000
  60. Universities or companies site license: US$250
  61. Curtin University and the University of Western Australia are exempt.
  62. Single-user license: US$10.
  63.  
  64. If you purchase a site license, contact me for information on how to make this program automatically set the “I Paid” flag in the Preferences dialog (for those who are interested, I leave the “I Paid” checkbox off on my machine to ensure that the About box is not too annoying and it doesn’t trouble me, so live with it)
  65.  
  66. You may distribute this program any way you wish as long as you don't charge for it (reasonable download costs such as Compu$erve are ok I guess (although who would call Compu$erve’s download costs reasonable?)).  It would probably be a good idea to keep this documentation file with the program, but I’m hardly likely to check up on you now am I!  I don’t guarantee any support, but I always answer my Email.  If I don’t answer Email its because your message didn’t get to me, or my reply bounced, so try again and include a valid Internet address if you can.
  67.  
  68. You MAY NOT DISTRIBUTE this program on any disk costing more than $5 without my explicit permission.
  69.  
  70. • Warranty
  71.  
  72. This program should do what I’ve described in this document.  If it doesn’t, you can simply stop using it.  If you pay me, and within a year find that it doesn’t do what I describe here, then you can notify me and I will refund your money and cancel your license.
  73.  
  74. • Fine Print
  75.  
  76. Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose.  Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages.  In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim.  The person using the software bears all risk as to the quality and performance of the software.
  77.  
  78. US Governement:
  79.         Government End Users:  If you are acquiring the Software and fonts
  80. on behalf of any unit or agency of the United States Government, the
  81. following provisions apply.  The Government agrees:
  82.         (i) if the Software and fonts are supplied to the Department of
  83. Defense (DoD), the Software and fonts are classified as "Commercial
  84. Computer Software" and the Government is acquiring only "restricted rights"
  85. in the Software, its documentation and fonts as that term is defined in
  86. Clause 252.227-7013(c)(1) of the DFARS; and
  87.         (ii) if the Software and fonts are supplied to any unit or agency
  88. of the United States Government other than DoD, the Government's rights in
  89. the Software, its documentation and fonts will be as defined in Clause
  90. 52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause
  91. 18-52.227-86(d) of the NASA Supplement to the FAR.
  92.  
  93. • Version History
  94.  
  95. Still to think about doing -
  96.  
  97. page up/down keys
  98. Another observation - the scroll bars in the finger results window don't de-active?
  99. Might be kinda nice to have a pop-up that could hold frequently used
  100. machine names next to the machine name field. For instance, I often want to
  101.  
  102. Checkbox for "save address in finger menu" in Finger Input
  103. Save window positions.
  104. Restrict Finger output window to 80 column resizing.
  105. Windows menu.
  106. Saving finger output window.
  107.  
  108. v1.5.0d1
  109. ~AppleScript/recording support
  110. ~Saving/Opening AURL documents
  111. ~Removed fingerd support (use Daemon instead)
  112.  
  113. v1.3.7
  114. ~Fixed the mess I made of Fingerd
  115. ~A couple other bug fixes
  116. ~Updated the Email address
  117.  
  118. v1.3.6
  119. ~Fixed incompatibility with AppleScript
  120. ~A couple bug fixes
  121.  
  122. v1.3.5
  123. ~Changed %LOG to put a time stamp in as well.
  124. ~Colourized icons - Thanks to Don Nash for the icons.
  125. ~Fixed it so that the strings which are returned by tokens are translated 7->8
  126. ~Fixed %LOOKUP to not uppercase the line.
  127.  
  128. v1.3.3
  129. ~Added Option-Quit to quit the daemon.
  130. ~Change "Finger" to "Whois" when you click the Whois check box
  131.  
  132. v1.3.1
  133. ~Crash with error 25 when Finger text is selected
  134. ~Should be more difficult to crash with out of memory, though still not impossible.
  135. ~Bug with edit menu selections.
  136. ~Crash with dragging non-fron windows
  137. ~Added in support for the file Translate 7<->8 for foreign character sets.
  138.  
  139. v1.3.0
  140. ~Have setable default for the Finger window.
  141. ~Find a more intuitive way of saving the Finger-> menu.
  142. ~Add a pref to Finger to auto-open the Finger… dialog on startup - Tom McDougal
  143. ~Reverse user/machine name?
  144. ~Allow chained fingering (eg root@foo.edu@bar.edu), at least in the client.
  145.  
  146. v1.2.1 Release 3 Dec/91
  147. NOTE: The Finger 1.2.1 release incorrectly included Fingerd 1.1.5. :-(
  148. ~Solved a bug to do with QUIT apple events, that caused Fingerd to crash on shutdown.
  149.  
  150. v1.1.5 Release 2 Dec/91
  151. ~Print cancel button produced an error message - Albert Smith
  152. ~Avoid crashing in MonoFinder systems - JQ Johnson
  153. ~Changed from striping incoming <lf>s, to striping <cr>s, and converting <lf> to <cr>
  154. ~Support Whois query in Finger - JQ Johnson
  155. ~Handle multiple daemon connections under MacTCP 1.1.  The max is specified in STR#=129.  By default the maximum for Finger is 2 daemons, and for Fingerd is 1.
  156. ~Support quit apple event in daemon - Stuart Cheshire.
  157. ~Extend %FILES to return file ? for missing file, and @ for blank user - S. Cheshire
  158. ~Enable the Edit menu, seeing as how it works anyway
  159. ~Find the correct Prefs folder on all systems - Bien amicalement
  160. ~Put port into rsrc fork so it can be easily changed to a whois server - JQ Johnson
  161. ~Handle 7<->8 bit conversions - Ari Ahonen
  162. ~Allow recursive expansion of tokens under tokens like %FILES - Stuart Cheshire.
  163.    More importantly, recursive expansion of <cr> to <cr><lf>! - Ari Ahonen.
  164. ~Handle out of memory a bit more gracefully (like only one OoM dialog) - Brian Kendig.
  165.  
  166. v1.0.6g Interim non-release
  167. ~Fix crash related to low end macs with little memory (stack space problem)
  168.  
  169. v1.0.6 Release 1 Nov/91
  170. -Some sort of edit feature to insert the current time chars - Dave White
  171.    Scrapped due to change from international chars to tokens.
  172.  
  173. v1.0.4 Beta Release 3
  174. ~Make Finger's tokens extensible!
  175. ~Use tokens instead of silly characters.
  176. ~Window opens only after all finger info is read, and a busy cursor is displayed
  177. ~Zoom the window after reading the plan - Robert Beckett
  178.  
  179. v1.0.2 Beta Release 2
  180.  
  181. ~Problems with 6.0.5 and Finger - Rob Trevor
  182. ~Crashes on a SE with System 6.0.4, MacTCP 1.0.2 when you unset the plan check box
  183. ~   - Ian Hoyle
  184. ~Running Finger/Daemon with Fingerd gives sys error 'Fingerd' error type 11
  185. ~   - Chris Price
  186.  
  187. ~1) It would be nice to have a print command to get a hard copy of the
  188. response from a finger query - Greg Webb
  189. ~A "Dial" menu - Rodney Vickers
  190. ~2) I think you should change the cursor to a watch while the query is being
  191. made. At present, the cursor disappears - Greg Webb
  192. [I ShowCursor to make it reappear.  It isn't a watch because Finger isn't locked up]
  193. ~3) Minor point. Under Help, the text says 'Use the Finger menu...' I think
  194. that should read 'Use the Finger command...' or 'Use the Finger command
  195. from the File menu...' - Greg Webb
  196. ~Use other than chicago font in about/help/etc - Danny Thomas
  197. ~Dim the OK button until a reasonably valid machine name is in the dialog box
  198.    - Danny Thomas
  199. ~Dim the check box out until the plan is selected. - Danny Thomas
  200. ~Remember the plan on different volumes (I think I've fixed this) - Quinn
  201.  
  202. v1.0.0 Beta Release 1
  203. ~Bug in TEActivate (Finger @rocky, then finger @twinpeaks, then click OK -> bus err)
  204. ~Increase the 10k mem restriction if the about, help, prefs windows are not open, 
  205.      or finger windows are open. - Grow Zone should fix most mem problems.
  206. ~Fingering yourself doesn't work.  It really shouldn't crash the machine.
  207. ~You should be able to copy out of the Finger windows.
  208. ~Scroll bars.
  209.  
  210. • Acknowledgements
  211.  
  212. Thanks go to Quinn&Todd for initial beta testing, and to Rhys for help debugging TCP (fun fun fun!), and generally to DRJQ, the UCC, Curtin, Steve, c.s.m.p, ditmela.oz.au (& Harold), (ftp.)apple.com, Stephen, and anyone who uses Finger/Fingerd!  Special thanks go to those brave souls who risked life and Mac beta testing an unknown program: Oliver, Ian, Paul, Dave, Adrian, Phil, Robin, Rodney, Allan (again!), Chris, Adam, Robert, Rob, Phill, Greg, Alf, Danny and Michael!  Many thanks to JQ Johnson, Stuart Cheshire, Bien amicalement, Ari Ahonen & Brian Kendig who suggested many of the improvements to version 1.0.6.
  213.